Goal

Align the Compose SDK theming with the Figma Chat SDK Design System by introducing a unified StreamDesign namespace for all design tokens (colors, typography, dimensions), removing legacy abstractions that no longer have Figma backing, and eliminating redundant intermediate component themes superseded by ChatComponentFactory.

Implementation

The theming layer was refactored in several incremental phases:

1. StreamDesign namespace — Consolidated StreamColors, StreamTypography, StreamShapes, and StreamDimens into nested data classes under a single StreamDesign object. Primitive tokens (StreamPrimitiveColors, StreamTokens) remain internal; integrators work exclusively with semantic tokens via StreamDesign.Colors, StreamDesign.Typography, and StreamDesign.Dimens.

2. Colors alignment — Removed 23 legacy XML-backed color delegates (e.g. textHighEmphasis, barsBackground, primaryAccent) from StreamDesign.Colors, replaced them with ~100 Figma-aligned semantic tokens, and migrated ~280 call sites across all modules. Default factories are now pure Kotlin (no more colorResource() calls).

3. Typography alignment — Removed 13 legacy typography properties (e.g. title1, body, footnote, singleEmoji) and replaced them with 12 Figma-aligned tokens (e.g. headingLarge, bodyDefault, metadataEmphasis). Special styles (bodyItalic, emojiOnly) are inlined at call sites with TODO markers for future dedicated tokens.

4. Component theme removal — Deleted 5 intermediate themes (AttachmentPickerTheme, MessageDateSeparatorTheme, MessageUnreadSeparatorTheme, AttachmentsPreviewTheme, AudioRecordingAttachmentPreviewTheme) whose properties were either unused or trivially derivable from StreamDesign tokens. Styling was inlined at call sites.

5. Shapes removal — Removed StreamDesign.Shapes entirely (no Figma backing, superseded by ChatComponentFactory). Deleted 3 dead properties (myMessageBubble, otherMessageBubble, quotedAttachment), inlined the 8 used shapes at ~35 call sites using StreamTokens radius references.

6. Typealias removal — Removed all deprecated typealiases (StreamColors, StreamTypography, StreamDimens, StreamShapes) and their deprecated factory shims (defaultColors(), defaultTypography(), defaultDimens()). All code now uses StreamDesign.* types directly.

classDiagram
    class StreamDesign {
        <<object>>
    }
    class Colors {
        <<@Immutable data class>>
    }
    class Typography {
        <<@Immutable data class>>
    }
    class Dimens {
        <<@Immutable data class>>
    }
    class StreamPrimitiveColors {
        <<internal object>>
    }
    class StreamTokens {
        <<internal object>>
    }
    class ChatTheme {
        <<Composable>>
    }

    StreamDesign *-- Colors : nested
    StreamDesign *-- Typography : nested
    StreamDesign *-- Dimens : nested
    Colors ..> StreamPrimitiveColors : references internally
    Colors ..> StreamTokens : references internally
    Typography ..> StreamTokens : references internally
    ChatTheme ..> Colors : provides via CompositionLocal
    ChatTheme ..> Typography : provides via CompositionLocal
    ChatTheme ..> Dimens : provides via CompositionLocal

Testing

Smoke-test the Compose sample app in both light and dark mode. Walk through the core flows — channel list, message list, message composer, attachment picker, reactions, and polls — and confirm the UI renders correctly with no visual regressions or crashes.